Fpipe

Section: Oct. 1, 1991 (2)
Updated: MiNT Programmer's Manual
Index Return to Main Contents

NAME

Fpipe - create a pipe

SYNOPSIS

LONG Fpipe( WORD usrh[2] );

DESCRIPTION

Fpipe creates a pipe that may be used for interprocess communication. If it is successful, two GEMDOS handles are returned in usrh[0] and usrh[1]. usrh[0] will contain a handle for the read end of the pipe, (opened for reading only), and usrh[1] will contain a handle for the write end of the pipe (opened for writing only).

The created pipe has the name "sys$pipe.xxx", where "xxx" is a three digit integer.

USAGE

Typically used by shells; the shell redirects its standard input (or standard output) to the read (or write) end of the pipe using Fdup and Fforce before launching a child; the child will then read from (or write to) the pipe by default.

RETURNS

0 if successful

ENHNDL if there are not 2 free handles to allocate for the pipe

ENSMEM if there is not enough free memory to create the pipe

EACCDN if too many pipes already exist in the system

BUGS

There cannot be more than 999 open pipes in the system at one time.

This document was created by man2html, using the manual pages.
Time: 16:01:47 GMT, March 03, 2023